home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Night Owl 19
/
Night Owl (The Best of Shareware)(NOPV 19)(1996).ISO
/
007a
/
statsp4c.zip
/
STATUSP.DOC
< prev
next >
Wrap
Text File
|
1996-01-01
|
22KB
|
490 lines
Network Mail Status - Postlink Version
═════════════════════════════════════════════════════════════════
First off I would like to thank those users who have offered
suggestions and made comments on StatusP. Some functions and
displays, even CleanUpP (formally CleanUp), and other versions
are the direct result of this input.
(1) Generates a network Export mail status bulletin showing
each conference (full 24 characters for conference names), 1500
maximum, and the total number of messages exported for current
date and total to date for each conferences, total conferences
and the total messages to date for the specified network.
(2) Generates a network Import mail status bulletin with the
same format as the Export bulletin. Since the export routine
contains all conference names it is run first to get those names
so that conferences with zero imports are still displayed in the
import bulletin. I could not find another way to get all
conference names.
(3) Generates last import bulletin showing last import
information: date, time, total messages imported in last import
and total messages imported to date.
(4) Generates, or appends to the end of, a monthly totals
bulletin called network.TOT with each rollover. This bulletin
contains the total lines from previous Export and Import
bulletins along with header.
Supports multiple networks. This program uses Postlink's
export / import log(s). Single or separate Import and Export
logs. It does a monthly rollover of the LOG(s) using PKWare's
PKZIP.EXE (copyright PKWare).
This archive should contain the following files:
CLEANUPP.DOC.......... Instructions for running CleanUpP
CLEANUPP.EXE.......... Postlink log reduction utility
DOORS.TXT............. Current list of James Huckabey doors
FILE_ID.DIZ........... BBS description file
SHAREWARE.TXT......... Information about shareware
HUCKABEY.TXT.......... Current list of all James Huckabey
software
READ.ME............... Update/changes information
STATUSP.BAT........... Sample batch file
STATUSP.EXE........... Actual StatusP program
STATUSP.DOC........... Instructions for running StatusP
STATUSP.CFG........... Sample configuration file
STATUSP2.CFG.......... Sample configuration file
STATUSP3.CFG.......... Sample configuration file
ARCHIVE.TXT........... This list of files
Syntax is pretty straight forward:
STATUSP STATUSP.CFG
Full path to STATUSP.EXE may be used if not in path or in
current directory. If you do use a path statement in your
execution of Status (not in current dir or in path) you need to
set the environment variable "SET STATUSP=path to STATUSP.EXE"
(SET STATUSP=C:\UTILITY\OTHER, etc. no ending slash is needed).
It is not necessary to add a path statement to the
configuration file since the program finds itself. Of course the
file must be in location of STATUSP.EXE. If the configuration
file is not in the same location then use the path statement to
it's location.
"STATUSP.CFG" and can have any file name with the following
format. You can use up to 8 characters of your network name for
the name of your .CFG file if that helps keep multi-network
configurations clearer. This would be the easiest way to do it.
Each line must be populated with a valid entry. Paths to
bulletins or logs are not needed if they are in or written to the
current directory:
(1) Unregistered BBS
(2) 0000
(3) Network
(4) POST1.LOG
(5) C:\BBS\BLT1
(6) POST2.LOG
(7) C:\BBS\BLT2
(8) C:\BBS\BLT3
(9) PCB
(10) Bright
CFG line #1
"Unregistered BBS", BBS name if registered.
CFG line #2
"0000", valid serial number if registered.
CFG line #3
"Network" should be the name of the actual network you are
using, one word and case sensitive (Rime, AccessNet, etc.). 18
characters max, longer names are truncated. Say you are making
two different network mail runs with the same software, you would
use those names here, each in it's own configuration file.
CFG line #4
"POST1.LOG" is the path and name of your Postlink Export
log. Lines #4 and #6 may contain the same file name if your
Export and Import logs are in one file.
CFG line #5
"C:\BBS\BLT1" is the path and name for your Export bulletin.
CFG line #6
"POST2.LOG" is the path and name of your Postlink Import
log. Lines #4 and #6 may contain the same file name if your
Export and Import logs are in one file.
CFG line #7
"C:\BBS\BLT2" is the path and name for your Import bulletin.
CFG line #8
"C:\BBS\BLT3" is the path and name for your Last Import
bulletin. If you are not using this option the file can just be
written out to the current directory, but it must be generated.
CFG line #9
Color and characters used are setup to give you as much
control over the output as possible. Not all users can read and
handle IBM extended graphic characters (like sight impaired users
and voice hardware). Program can use either "=/-" or IBM's
extended graphic characters "═/─". Line #9 must contain one of
the following options:
"PCB" use IBM extended graphic characters and PCBoard's @X0
colorizing codes.
"PCB2" use no IBM extended graphic characters and PCBoard's
@X0 colorizing codes.
"ANSI" use colorizing and no IBM extended graphic
characters.
"ANSI2" use colorizing and IBM extended graphic characters.
"ASCII" use no colorizing and no IBM extended graphic
characters.
"ASCII2" use no colorizing, but use IBM extended graphic
characters.
CFG line #10
Text Tone: This option can either be Bright or Normal. The
default is BRIGHT. Even if you are using an ASCII option you must
still populate this option.
STATUSP TOTAL FILE(s)
This file, StatusP Totals, is written to the current
directory only. Current directory is the directory where you call
STATUSP.EXE from. The file name is the first eight alphabetical
characters of your network name. That way if you are making
multiple network mail runs each network will have it's own totals
file. The extension is always "TOT".
Please make note that if your copy of StatusP is not
registered that the total file will have "Unregistered BBS" in
the BBS line of the bulletin. If you keep the file and register
StatusP you will have to edit the top line of the bulletin or
erase the file and start over.
This file/bulletin has unlimited possibilities. If you are
making more than one StatusP execution, say for different
formats, only the first one will be executed with the rollover.
So this file will only contain that color format. It is complete
with whatever color codes existed in the original bulletin. The
colors can be removed or replaced with whatever colors you want
manually using a text editor.
The file has a three line header when first created, (1)
line with BBS name in it, (2) an explanation of what it is, (3) a
header termination line. It then has one line for Export total
and one line for Import total followed by a blank separation
line. Each successive appendage is three lines total. A year's
worth of information would have a total of thirty-nine lines.
What you do with this information is up to you. Just another
friendly option added to the program. If you are going to use it
as an active bulletin it can be copied anywhere you want. Just
make sure that if you want the next rollover appended to the end
that you keep the file in the current directory for the execution
of StatusP. If you change this directory make sure you move the
total bulletin(s) to your new directory.
Special Bulletins Showing Totals Each Conference
It is possible to make a "Previous Month's" activity
bulletin out of the rolled over log(s). At least the data would
be all there and compacted if you have used CleanUpP. All you
have to do is make a special STATUSP.CFG file with the name of
the bulletins for these special monthly Bulletins. You could do
one each month for the previous month. The bulletin for the Last
Import could just be written to the current directory and not
used. For a full month the Bulletins would have something like
01-01-95 to 01-31-95 for the time period as this would be the
dates in a log for January 1995.
Of course the above would work even if you did not run
CleanUpP.
It should be noted that when you start using StatusP for the
first time that if your Postlink log(s) are not just the current
month's log(s) that the log does not roll over until the month in
the log equals your system's current month (change from earlier
versions). The first archive will contain everything to date. The
new log will start at the first current month's date StatusP
finds in the current month's log. Bulletins generated will show
information only for the current month and from this point on
each roll over archive will contain only the previous month's
log.
Errors
Errors are written to the same directory as STATUSP.EXE in a
file called STATUSP.ERR. If the file already exists additional
errors are appended to the end of the file. It may be deleted
after you have made note of any errors. It's existence it not
required by the program.
During the start up procedures that program displays
"Searching!" while it is looking for the directory STATUSP.EXE is
located in. Also "Configuring!" while it is reading in and
verifying all information in the configuration file. These are to
show you what the program is doing should lockups occur. I had
problems in these areas and took some time to isolate them. At
least now these problem areas can be isolated. Normally these two
displays should be very quick and unreadable depending on system
speed and StatusP' configuration.
The program confirms each item in the configuration file
before it does anything else. Program aborts if each option
cannot be confirmed.
If StatusP has trouble finding the log(s) it first tries to
create a "no data bulletin" and do an normal error exit. If it
cannot create these bulletins it makes an error exit that
displays the help screen. These two exits would normally be an
error in the configuration file: wrong path, wrong file name,
configuration file name not used, etc.
If the program has any problems with your log(s) such as no
exported conferences found, a bulletin is generated showing that
information, but no error information is written to the
STATUSP.ERR. If no imported/exported messages are found the
program aborts writing out a no message bulletin for Export and
Import along with writing out to STATUSP.ERR.
Using Postlink
If you are making two or more DIFFERENT network mail runs
the only thing you must do is make two or more different
POSTLINK.CFG files, one with the name of the LOG file for each
network so that ALL logs are not put into one file. I would have
no way of knowing what messages came from what network in order
to separate them. You would then just have a TEMP1.CFG, TEMP2.CFG
and when you call postlink you just copy TEMP1.CFG POSTLINK.CFG,
then on next run you might copy TEMP2.CFG POSTLINK.CFG, etc.
A simple batch file might look like one of these:
SET STATUSP=C:\UTILITY
CD \POSTLINK
COPY TEMP1.CFG POSTLINK.CFG
POSTLINK CALLER.CFG
STATUSP STATUSP.CFG
SET STATUSP=
SET STATUSP=C:\UTILITY
CD \POSTLINK
Copy TEMP2.CFG POSTLINK.CFG
POSTLINK CALLER2.CFG
C:\UTILITY\STATUSP STATUSP2.CFG
SET STATUSP=
Perhaps you want to make a bulletin with the PCBoard color
codes and one using straight ASCII codes and yet another using
ANSI codes, Bright or Normal Text Tone. The .CFG files would
contain the bulletin names and the form setting (#9):
STATUSP STATUSP.CFG
(.CFG with PCB, uses PCBoard color codes and IBM extended
graphic characters and bright text tone)
STATUSP STATUSP2.CFG
(.CFG with ASCII, ASCII and no IBM extended graphic
characters and normal text tone [must be populated])
STATUSP STATUSP3.CFG
(.CFG with ANSI, ANSI colors and no IBM extended graphic
characters and normal text tone)
You just call STATUSP as many times as needed, with as many
configuration files as needed to generate whatever formats you
want. On my 486-33 it takes less than twenty seconds to run the
program on a 6,500 line test log (from three BBS systems).
PKZIP.EXE used by the StatusP Program
"PKZIP.EXE" must be somewhere in your path or in the current
directory. When the month changes in the export/import.log the
program archives the current log into a file using 'SP'+ the
current date (SP010193.ZIP, etc.). It also includes the current
logs (1 or 2) and all three bulletins. It creates this in the
directory that contains the log file(s). The program then
rewrites the log using only the current new month's data. This
way there is only one month's log data in your Postlink log(s).
The bulletins are added to the archive so the last
information posted on the BBS before rollover is available should
this information be required by the you.
If you do not want the previous month's log(s) simply delete
the archive from your hard drive. In your calling batch file you
can add "IF EXIST SP*.ZIP DEL SP*.ZIP" and this will auto-delete
the archive.
There must be at least one meg of free disk space for the
archive to be executed. I have no idea the possible sizes and if
anyone has problems with the archive with one meg as the minimum
please let me know and I will increase the size of the free space
required.
The StatusP Program
If you don't like the program please write to me and explain
why. Send me any suggestions you might have. If they enhance the
overall program I will try to incorporate part, some, all, in the
next release.
This program package represents many hours of programming,
testing, updating and more testing as well as LD telephone calls
to get it tested and to distribute the beta and release copies.
Please support my efforts and register your copy.
StatusP Registration
Please supply name of BBS to be added to program, up to
sixty characters. Anything longer than that will be truncated, no
exceptions. This is to be on one line of code and must be legible
since the serial number is based on exact syntax. I cannot be
responsible for unreadable data. Please print. Case sensitive!
For those who do not understand "case sensitive" I will
explain since some people do not seem to know the term. If you
send me your BBS name in all capital letters that is what your
serial number matches. If you send me your BBS name in all lower
case letters your this is what your serial number matches. If you
send me your BBS name in capital and lower case letters that is
what your serial number matches. Writing small capital letters is
not the same as lower case. I have gotten registrations where the
first letter of words in large capital letters and the rest of
the letters in that word in small capital letters. My
interpretation is that this is all uppercase/capital letters. By
match means that your configuration file must contain the same
format your serial number is based on: (1) all uppercase, (2) all
lower case, (3) mixed case.
Example: "Jim's Graphic BBS". In StatusP it comes out as the
following in all bulletins generated:
==================(Jim's Graphic BBS)==================
StatusP Registration Form
[-------------------------------------------------------------]
(put BBS name above)
Send BBS information and one of the following in $ U.S.
(1) Registration via mail............................$12
(outside U.S./Canada please add $2)
(2) Registration and latest version via mail......... $14
(outside U.S./Canada please add $4) Include diskette
size.
(3) Registration and latest version via mail and copy
of all James Huckabey Doors and PC software...... $17
(outside U.S./Canada please add $5) Include diskette
size.
Option: 1: [ ] 2: [ ] 3: [ ]
Diskette Size: 360: [ ] 1.2: [ ] 720: [ ] 1.44: [ ]
Your current version number: [ ]
FROM:
Name:
---------------------------------------------------
Address:
---------------------------------------------------
City:
---------------------------------------------------
State & Zip:
---------------------------------------------------
NODE ID: SITE NO:
---------------------- ---------------------
Phone(voice): (data)
---------------------- ---------------------
Your registration number and any diskettes, if requesting
current version or other software, are sent by return mail.
James Huckabey
3621-A Fraser Street
Bellingham, Washington 98226-2473 U.S.A.
(360) 671-2868 (voice, Pacific)
I do have a US Robotics HST 14.4 DS v32 v42 v42bis modem!